home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qbitarray.Z / qbitarray
Encoding:
Text File  |  1998-10-28  |  22.6 KB  |  397 lines
  1.  
  2.  
  3.  
  4.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       QBitArray - Array of bits
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <qbitarray.h>
  13.  
  14.       Inherits QByteArray.
  15.  
  16.     PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  17.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy (((())))
  18.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy (((( uuuuiiiinnnntttt ssssiiiizzzzeeee    ))))
  19.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy (((( ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&&    aaaa ))))
  20.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy&&&& ooooppppeeeerrrraaaattttoooorrrr==== (((( ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& ))))
  21.       uuuuiiiinnnntttt ssssiiiizzzzeeee (((()))) ccccoooonnnnsssstttt
  22.       bbbboooooooollll rrrreeeessssiiiizzzzeeee ((((    uuuuiiiinnnntttt ssssiiiizzzzeeee ))))
  23.       bbbboooooooollll ffffiiiillllllll (((( bbbboooooooollll _v,,,, iiiinnnntttt _s_i_z_e ==== ----1111 ))))
  24.       vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd ddddeeeettttaaaacccchhhh (((())))
  25.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy ccccooooppppyyyy (((()))) ccccoooonnnnsssstttt
  26.       bbbboooooooollll tttteeeessssttttBBBBiiiitttt (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx )))) ccccoooonnnnsssstttt
  27.       vvvvooooiiiidddd sssseeeettttBBBBiiiitttt ((((    uuuuiiiinnnntttt iiiinnnnddddeeeexxxx ))))
  28.       vvvvooooiiiidddd sssseeeettttBBBBiiiitttt ((((    uuuuiiiinnnntttt _i_n_d_e_x,,,, bbbboooooooollll vvvvaaaalllluuuueeee ))))
  29.       vvvvooooiiiidddd cccclllleeeeaaaarrrrBBBBiiiitttt    (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx ))))
  30.       bbbboooooooollll ttttoooogggggggglllleeeeBBBBiiiitttt (((( uuuuiiiinnnntttt    iiiinnnnddddeeeexxxx ))))
  31.       bbbboooooooollll aaaatttt (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx )))) ccccoooonnnnsssstttt
  32.       QQQQBBBBiiiittttVVVVaaaallll ooooppppeeeerrrraaaattttoooorrrr[[[[]]]] (((( iiiinnnntttt iiiinnnnddddeeeexxxx ))))
  33.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy&&&& ooooppppeeeerrrraaaattttoooorrrr&&&&====    (((( ccccoooonnnnsssstttt    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& ))))
  34.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy&&&& ooooppppeeeerrrraaaattttoooorrrr||||====    (((( ccccoooonnnnsssstttt    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& ))))
  35.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy&&&& ooooppppeeeerrrraaaattttoooorrrr^^^^====    (((( ccccoooonnnnsssstttt    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& ))))
  36.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy ooooppppeeeerrrraaaattttoooorrrr~~~~ (((()))) ccccoooonnnnsssstttt
  37.  
  38.     PPPPrrrrooootttteeeecccctttteeeedddd MMMMeeeemmmmbbbbeeeerrrrssss
  39.       vvvviiiirrrrttttuuuuaaaallll aaaarrrrrrrraaaayyyy____ddddaaaattttaaaa**** nnnneeeewwwwDDDDaaaattttaaaa (((())))
  40.       vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd ddddeeeelllleeeetttteeeeDDDDaaaattttaaaa (((( aaaarrrrrrrraaaayyyy____ddddaaaattttaaaa **** dddd ))))
  41.  
  42.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  43.       (Note    that these are not member functions.)
  44.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy ooooppppeeeerrrraaaattttoooorrrr&&&& ((((ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& _a_1,,,, ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&&
  45.           _a_2))))
  46.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy ooooppppeeeerrrraaaattttoooorrrr|||| ((((ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& _a_1,,,, ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&&
  47.           _a_2))))
  48.       QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy ooooppppeeeerrrraaaattttoooorrrr^^^^ ((((ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& _a_1,,,, ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&&
  49.           _a_2))))
  50.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&&
  51.           _a))))
  52.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& _a))))
  53.  
  54.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  55.       The QBitArray    class provides an array    of bits.
  56.  
  57.       QString inherits QByteArray, which is    defined    as
  58.       QArray<char>.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 9/22/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  71.  
  72.  
  73.  
  74.       Since    QBitArray is a QArray, it uses explicit    sharing    with a
  75.       reference count.
  76.  
  77.       A QBitArray is a special byte    array that can access
  78.       individual bits and perform bit-operations (AND, OR, XOR and
  79.       NOT) on entire arrays    or bits.
  80.  
  81.       Bits can be manipulated by the setBit() and clearBit()
  82.       functions, but it is also possible to    use the    indexing []
  83.       operator to test and set individual bits. The    [] operator is
  84.       a little slower than the others, because some    tricks are
  85.       required to implement    single-bit assignments.
  86.  
  87.       Example:
  88.  
  89.           QBitArray    a(3);
  90.           a.setBit(    0 );
  91.           a.clearBit( 1 );
  92.           a.setBit(    2 );              // a = [1 0 1]
  93.           QBitArray    b(3);
  94.           b[0] = 1;
  95.           b[1] = 1;
  96.           b[2] = 0;                  // b = [1 1 0]
  97.           QBitArray    c;
  98.           c    = ~a & b;              // c = [0 1 0]
  99.  
  100.      MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  101.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy (((())))
  102.       Constructs an    empty bit array.
  103.  
  104.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy (((( ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& aaaa    ))))
  105.       Constructs a shallow copy of _a.
  106.  
  107.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy (((( uuuuiiiinnnntttt ssssiiiizzzzeeee ))))
  108.       Constructs a bit array of _s_i_z_e bits. The bits    are
  109.       uninitialized.
  110.  
  111.      bbbboooooooollll QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::aaaatttt    (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx )))) ccccoooonnnnsssstttt
  112.       Returns the value (0 or 1) of    the bit    at position _i_n_d_e_x.
  113.  
  114.       See also: operator[].
  115.  
  116.      vvvvooooiiiidddd QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::cccclllleeeeaaaarrrrBBBBiiiitttt ((((    uuuuiiiinnnntttt iiiinnnnddddeeeexxxx ))))
  117.       Clears the bit at position _i_n_d_e_x (sets it to 0).
  118.  
  119.       See also: setBit() and toggleBit().
  120.  
  121.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ccccooooppppyyyy (((()))) ccccoooonnnnsssstttt
  122.       Returns a deep copy of the bit array.
  123.  
  124.       See also: detach().
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 9/22/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  137.  
  138.  
  139.  
  140.      vvvvooooiiiidddd QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ddddeeeettttaaaacccchhhh (((()))) [[[[vvvviiiirrrrttttuuuuaaaallll]]]]
  141.       Detaches from    shared bit array data and makes    sure that this
  142.       bit array is the only    one referring the data.
  143.  
  144.       If multiple bit arrays share common data, this bit array
  145.       dereferences the data    and gets a copy    of the data. Nothing
  146.       will be done if there    is just    a single reference.
  147.  
  148.       See also: copy().
  149.  
  150.       Reimplemented    from QGArray.
  151.  
  152.      bbbboooooooollll QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ffffiiiillllllll (((( bbbboooooooollll vvvv,,,, iiiinnnntttt    ssssiiiizzzzeeee ==== ----1111 ))))
  153.       Fills    the bit    array with _v (1's if _v is TRUE,    or 0's if _v is
  154.       FALSE).
  155.  
  156.       Will resize the bit array to _s_i_z_e bits if _s_i_z_e is
  157.       nonnegative.
  158.  
  159.       Returns FALSE    if a nonnegative _s_i_z_e was specified and    if the
  160.       bit array could not be resized, otherwise returns TRUE.
  161.  
  162.       See also: resize().
  163.  
  164.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr&&&&==== (((( ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& aaaa ))))
  165.       Performs the AND operation between all bits in this bit
  166.       array    and _a. Returns a reference to this bit array.
  167.  
  168.       The two bit arrays must have the same    size. The debug
  169.       library will warn you    if they    aren't,    the production library
  170.       blithely ignores the problem.
  171.  
  172.       Example:
  173.  
  174.           QBitArray    a(3), b(3);
  175.           a[0] = 1;     a[1] =    0;      a[2] = 1;      // a = [1 0 1]
  176.           b[0] = 0;     b[1] =    0;      b[2] = 1;      // b = [0 0 1]
  177.           a    &= b;                      // a = [0 0 1]
  178.  
  179.       See also: operator|=(), operator^=() and operator~().
  180.  
  181.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr==== ((((    ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy    &&&& aaaa ))))
  182.       Assigns a shallow copy of _a to this bit array    and returns a
  183.       reference to this array.
  184.  
  185.      QQQQBBBBiiiittttVVVVaaaallll QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr[[[[]]]] (((( iiiinnnntttt iiiinnnnddddeeeexxxx ))))
  186.       Implements the [] operator for bit arrays.
  187.  
  188.       The returned QBitVal is a context object. It makes it
  189.       possible to get and set a single bit value.
  190.  
  191.       Example:
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 9/22/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  203.  
  204.  
  205.  
  206.           QBitArray    a( 3 );
  207.           a[0] = 0;
  208.           a[1] = 1;
  209.           a[2] = a[0] ^ a[1];
  210.  
  211.       The functions    testBit(), setBit() and    clearBit() are faster.
  212.  
  213.       See also: at().
  214.  
  215.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr^^^^==== (((( ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& aaaa ))))
  216.       Performs the XOR operation between all bits in this bit
  217.       array    and _a. Returns a reference to this bit array.
  218.  
  219.       The two bit arrays must have the same    size. The debug
  220.       library will warn you    if they    aren't,    the production library
  221.       blithely ignores the problem.
  222.  
  223.       Example:
  224.  
  225.           QBitArray    a(3), b(3);
  226.           a[0] = 1;     a[1] =    0;      a[2] = 1;      // a = [1 0 1]
  227.           b[0] = 0;     b[1] =    0;      b[2] = 1;      // b = [0 0 1]
  228.           a    ^= b;                      // a = [1 0 0]
  229.  
  230.       See also: operator&=(), operator|=() and operator~().
  231.  
  232.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr||||==== (((( ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& aaaa ))))
  233.       Performs the OR operation between all    bits in    this bit array
  234.       and _a. Returns a reference to    this bit array.
  235.  
  236.       The two bit arrays must have the same    size. The debug
  237.       library will warn you    if they    aren't,    the production library
  238.       blithely ignores the problem.
  239.  
  240.       Example:
  241.  
  242.           QBitArray    a(3), b(3);
  243.           a[0] = 1;     a[1] =    0;      a[2] = 1;      // a = [1 0 1]
  244.           b[0] = 0;     b[1] =    0;      b[2] = 1;      // b = [0 0 1]
  245.           a    |= b;                      // a = [1 0 1]
  246.  
  247.       See also: operator&=(), operator^=() and operator~().
  248.  
  249.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr~~~~ (((()))) ccccoooonnnnsssstttt
  250.       Returns a bit    array which contains the inverted bits of this
  251.       bit array.
  252.  
  253.       Example:
  254.  
  255.           QBitArray    a(3);
  256.           a[0] = 1;     a[1] =    0; a[2]    = 1;      // a = [1 0 1]
  257.           QBitArray    b = ~a;              // b = [0 1 0]
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 9/22/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  269.  
  270.  
  271.  
  272.      bbbboooooooollll QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::rrrreeeessssiiiizzzzeeee (((( uuuuiiiinnnntttt ssssiiiizzzzeeee    ))))
  273.       Resizes the bit array    to _s_i_z_e    bits. Returns TRUE if the bit
  274.       array    could be resized.
  275.  
  276.       When expanding the bit array,    the new    bits will be
  277.       uninitialized.
  278.  
  279.       See also: size().
  280.  
  281.      vvvvooooiiiidddd QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::sssseeeettttBBBBiiiitttt (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx ))))
  282.       Sets the bit at position _i_n_d_e_x (sets it to 1).
  283.  
  284.       See also: clearBit() and toggleBit().
  285.  
  286.      vvvvooooiiiidddd QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::sssseeeettttBBBBiiiitttt (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx,,,, bbbboooooooollll vvvvaaaalllluuuueeee ))))
  287.       Sets the bit at position _i_n_d_e_x to _v_a_l_u_e.
  288.  
  289.       Equivalent to:
  290.  
  291.           if ( value )
  292.           setBit( index    );
  293.           else
  294.           clearBit( index );
  295.  
  296.       See also: clearBit() and toggleBit().
  297.  
  298.      uuuuiiiinnnntttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ssssiiiizzzzeeee (((()))) ccccoooonnnnsssstttt
  299.       Returns the size (number of bits) of the bit array.
  300.  
  301.       See also: resize().
  302.  
  303.      bbbboooooooollll QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::tttteeeessssttttBBBBiiiitttt (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx )))) ccccoooonnnnsssstttt
  304.       Returns TRUE if the bit at position _i_n_d_e_x is set.
  305.  
  306.       See also: setBit() and clearBit().
  307.  
  308.      bbbboooooooollll QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy::::::::ttttoooogggggggglllleeeeBBBBiiiitttt (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx ))))
  309.       Toggles the bit at position _i_n_d_e_x.
  310.  
  311.       If the previous value    was 0, the new value will be 1.    If the
  312.       previous value was 1,    the new    value will be 0.
  313.  
  314.       See also: setBit() and clearBit().
  315.  
  316.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  317.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy ooooppppeeeerrrraaaattttoooorrrr&&&& ((((ccccoooonnnnsssstttt    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& aaaa1111,,,,    ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy    &&&& aaaa2222))))
  318.       Returns the AND result between the bit arrays    _a_1 and _a_2.
  319.  
  320.       See also: QBitArray::operator&=().
  321.  
  322.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy ooooppppeeeerrrraaaattttoooorrrr|||| ((((ccccoooonnnnsssstttt    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& aaaa1111,,,,    ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy    &&&& aaaa2222))))
  323.       Returns the OR result    between    the bit    arrays _a_1 and _a_2.
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 9/22/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  335.  
  336.  
  337.  
  338.       See also: QBitArray::operator|=().
  339.  
  340.      QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy ooooppppeeeerrrraaaattttoooorrrr^^^^ ((((ccccoooonnnnsssstttt    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& aaaa1111,,,,    ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy    &&&& aaaa2222))))
  341.       Returns the XOR result between the bit arrays    _a_1 and _a_2.
  342.  
  343.       See also: QBitArray::operator^().
  344.  
  345.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    ccccoooonnnnsssstttt QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy    &&&& aaaa))))
  346.       Writes a bit array to    a stream.
  347.  
  348.       Serialization    format:
  349.  
  350.       1    The array size (UINT32)
  351.  
  352.       2    The array bits, (size+7)/8 bytes
  353.  
  354.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    QQQQBBBBiiiittttAAAArrrrrrrraaaayyyy &&&& aaaa))))
  355.       Reads    a bit array from a stream.
  356.  
  357.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  358.       hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqbbbbiiiittttaaaarrrrrrrraaaayyyy....hhhhttttmmmmllll
  359.  
  360.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  361.       Copyright 1992-1997 Troll Tech AS.  See the LICENSE file
  362.       included in the distribution for a complete license
  363.       statement.
  364.  
  365.      AAAAUUUUTTTTHHHHOOOORRRR
  366.       Generated automatically from the source code.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 9/22/98)
  394.  
  395.  
  396.  
  397.